home *** CD-ROM | disk | FTP | other *** search
/ Ham Exams / Ham Exams.iso / HAMEXAMS / EXAMS / EXAM20 / EXAM.DOC < prev    next >
Encoding:
Text File  |  1994-09-08  |  14.3 KB  |  339 lines
  1.                                 Exam Generator
  2.                       Shareware version 2.0 - 09 Sep 1994
  3.                Copyright 1991-1994 Affordable Computer Services
  4.                               All Rights Reserved
  5.                       Written by George Steinmetz, KB2FZH
  6.  
  7. DESCRIPTION
  8.  
  9. Exam Generator is used to take multiple choice exams.  A question pool is
  10. loaded from disk and random questions are selected from the pool.  Selections
  11. may be entered via keyboard or mouse.
  12.  
  13. This program was made generic so it can be used for any type of exam.  However,
  14. it was originally written to administer Amateur Radio exams using the FCC
  15. question pools. These pools are included as part of the program's package.
  16.  
  17. NOTE:  To take the amateur radio exams on a computer with a monochrome or CGA
  18. card, copies of the exams are necessary, as the program tells you to look at
  19. them when a diagram is used for a particular question.  These exams are in the
  20. ARRL (American Radio Relay League) and Radio Shack license manuals.  (The ARRL
  21. books are better for this purpose because the answers are listed in a separate
  22. section; Radio Shack's exam manuals list the answer after each question.
  23.  
  24.  
  25. FILE LISTING
  26.  
  27. The Exam Generator package comes with the following files:
  28.  
  29. EXAM.EXE      (main program)
  30. EXAM.DOC      (documentation)
  31. MSHERC.COM    (TSR to display diagrams on Hercules or MGA cards)
  32. POOLS\2.EXM   (Amateur Radio Element 2 question pool)
  33. POOLS\3A.EXM  (Amateur Radio Element 3A question pool)
  34. POOLS\3B.EXM  (Amateur Radio Element 3B question pool)
  35. POOLS\4A.EXM  (Amateur Radio Element 4A question pool)
  36. POOLS\4B.EXM  (Amateur Radio Element 4B question pool)
  37. EGA\*.EGA     (Amateur Radio EGA graphic files)
  38. HERC\*.HRC    (Amateur Radio Hercules graphic files)
  39.  
  40.  
  41. INSTALLATION
  42.  
  43. Create the directory you want Exam Generator installed in, such as C:\EXAM. 
  44. Enter that directory (CD \EXAM if installing to C:\EXAM).  If you downloaded
  45. EXAM20.ZIP from a BBS, enter PKUNZIP -d EXAM20.  If you copied EXAM20.EXE from
  46. a disk, enter EXAM20 -d.  This will create the correct subdirectories and
  47. uncompress the files into them.
  48.  
  49. To conserve disk space, delete the files in the EGA subdirectory if you have a
  50. Hercules (monochrome graphics) card, or delete the files in the HERC directory
  51. if you have a VGA or EGA card.  If you have a CGA or monochrome card without
  52. graphics, you can delete both directories.
  53.  
  54.  
  55. COMMAND LINE OPTIONS
  56.  
  57. The default screen color is white text on a black background.  To change these
  58. colors, add SET FCOLOR=n and SET BCOLOR=n to your AUTOEXEC.BAT file.  (Replace
  59. n with a color code in the color chart below.)  These environment variables are
  60. used in most Affordable Computer Services programs.
  61.  
  62. FCOLOR and sets the foreground color; BCOLOR sets the background color.
  63.  
  64. Color chart (n = 0 - 15 for foreground, 0 - 7 for background)
  65.  
  66.  0 Black             4 Red               8 Gray             12 Light red
  67.  1 Blue              5 Magenta           9 Light blue       13 Light magenta
  68.  2 Green             6 Brown            10 Light green      14 Yellow
  69.  3 Cyan              7 White            11 Light cyan       15 Bright white
  70.  
  71. If a mouse is to be used, load the appropriate mouse driver before running this
  72. program.  If you wish to disable the mouse, either do not load a mouse driver,
  73. or run EXAM with the /NOMOUSE command line option (example:  EXAM /NOMOUSE).
  74.  
  75. If you are using a Hercules or other monochrome graphics adapter, run MSHERC
  76. (or LOADHIGH MSHERC) to load the required TSR to display the diagrams.
  77.  
  78. To run Exam Generator, enter the subdirectory Exam Generator is installed, then
  79. enter EXAM at the DOS prompt.
  80.  
  81. To force monochrome mode, use the /M command line option (enter EXAM /M).
  82.  
  83. If you will be printing exams, and your printer port is not LPT1, use the /LPTn
  84. parameter to specify the printer port (example:  EXAM /LPT3). 
  85.  
  86.  
  87. OPERATION
  88.  
  89. Main Menu
  90.  
  91. To make a selection, enter the corresponding number and press Enter, or press
  92. the corresponding function key (F1 = choice 1, etc), or move the mouse cursor
  93. to anywhere on the selection and click the left mouse button.
  94.  
  95.  
  96. Selection 1 - Load Exam File
  97.  
  98. An exam file must be loaded before taking an exam.  Load Exam File randomly
  99. selects a predetermined amount of questions from each section, and it loads all
  100. sections of the exam file.  When this option is selected, a directory of exam
  101. files is automatically displayed.  To load an exam, enter it's filename (the
  102. .EXM extension does not have to be entered) or move the mouse cursor on top of
  103. an exam file name and click the left mouse button.  If the exam is in a
  104. different directory, enter the path and filename.  To abort loading a file,
  105. press Escape.
  106.  
  107.  
  108. Selection 2 - Load Entire Section
  109.  
  110. This command is similar to the Load Exam File command.  Load Entire Section
  111. prompts for the section number to load.  It then loads every question in the
  112. selected section.  This selection is useful for training on a particular
  113. section of an exam.
  114.  
  115.  
  116. Selection 3 - Take Exam
  117.  
  118. To answer a question, press the corresponding answer key (A-E) or move the
  119. mouse cursor to anywhere on the answer and click the left mouse button.  To
  120. abort the exam, press Escape and answer the "Abort exam? (y/N)" question with
  121. Y.
  122.  
  123. If a question refers to a diagram, the word DIAGRAM will display in the top
  124. right corner of the screen.  If running on a computer with a VGA, EGA or
  125. Hercules graphics card, press the space bar or click the right mouse button to
  126. display the diagram.
  127.  
  128. To skip a question and return to it later, press S or click the center mouse
  129. button.  (If using a two button mouse, click both the left and right mouse
  130. buttons at the same time.)
  131.  
  132. At the end of the exam, your score will be displayed.  Press Enter to return to
  133. the main menu.
  134.  
  135.  
  136. EXAM FILES
  137.  
  138. Every line is preceded by a status character (always capitalized) or an
  139. apostrophe (').  They have the following meanings:
  140.  
  141.  P: The minimum passing grade (percentage from 0 to 100).
  142.  N: The number of questions to be selected from the following section of
  143.     questions.  An exam may contain multiple sections.  The end of a section is
  144.     marked by the beginning of the next section or the end of the file.
  145.  T: The title or number of the question (only displayed on answer keys).  Each
  146.     title must be different; the title is used to prevent duplicate questions
  147.     on an exam.
  148.  G: The graphic file name.  If a question refers to a diagram, the diagram is
  149.     stored on disk (see Graphic Files below) and the 1-8 character filename
  150.     (not the .EGA or .HRC extension) is entered on this line.
  151.  R: The right answer.  The answer is entered as Ctrl A-E (see below).
  152.  Q: The question.  If the question contains more than one line, each line of
  153.     the question starts with a Q.  A maximum of four lines can be entered in
  154.     the question, and each line can be a maximum of 80 characters (including
  155.     the status character.)
  156.  A, B, C, D, E:  Answers A-E.  Like the questions, if an answer contains more 
  157.     than one line, each line of the answer starts with it's status character,
  158.     up to a maximum of four lines each.  Each line can be a maximum of 77
  159.     characters (including the status character.)  If a question does not have a 
  160.     choice (ex: A-D, not using E), do not enter a line for the blank answer.
  161.  Apostrophe ('): A comment line, not loaded by the program.
  162.  
  163. Sample exam file:
  164.  
  165. 'Exam 1 (This line is not loaded by the program)
  166. P70 (70 percent is the minimum passing grade)
  167. N1 (One question is to be selected from this section)
  168. T1-1 (Question # 1-1)
  169. RA (Right answer is A)
  170. QFirst line of question
  171. QSecond line of question
  172. AAnswer A
  173. BAnswer B
  174. CAnswer C
  175. T1-2 (Question # 1-2)
  176. RB (Right answer is B)
  177. G1-2 (Graphic file 1-2.EGA or 1-2.HRC will be displayed with this question)
  178. QQuestion
  179. AAnswer A
  180. BAnswer B
  181. CAnswer C
  182. DAnswer D
  183. N2 (Two questions are to be selected from this section)
  184. (continue until last question)
  185.  
  186. Each section can have a maximum of 100 questions, and the total exam can have a
  187. maximum of 100 selected questions.  (The program's true limit is 200 questions,
  188. but only 100 answers can be printed when printing an exam.)
  189.  
  190. If a question or answer contains ++++, the words will be highlighted on the
  191. screen.  (Example:  If a question says "What is a ++++balun++++?", the word
  192. "balun" will be highlighted.  (This feature was added because ARRL was using it
  193. to highlight words, but they have stopped using it in newer exam files.)
  194.  
  195.  
  196. GRAPHIC FILES
  197.  
  198. The graphic files used in Exam Generator are in BSAVE format.  .EGA files are
  199. saved in EGA mode and .HRC files are saved in Hercules mode.  To create these
  200. files, I used PICEM by John Bridges to convert .PCX files into .BAS files. 
  201. PICEM is available for downloading on BBSes, including The Other BBS (its phone
  202. number is at the end of this file), search BBSes for PICEM*.*
  203.  
  204. To create your own graphic files, use a program such as PICEM to convert a file
  205. you have drawn/scanned to .BAS format.  Do this twice, once with the conversion
  206. program loaded in EGA mode, and once in Hercules mode.  Change the extension of
  207. the EGA file to .EGA and the Hercules file to .HRC.  (If you are certain that
  208. you will only need one graphic type, then you can just create one file, either
  209. .EGA or .HRC.)
  210.  
  211.  
  212. FILE USAGE
  213.  
  214. Exam Generator makes a temporary file ~EXAM.TMP when loading exams.  ~EXAM.TMP
  215. is created in the subdirectory named in the TEMP environment variable, or in
  216. the current directory if no TEMP environment variable exists.
  217.  
  218.  
  219. PROGRAM INFO
  220.  
  221. Exam Generator was written with Microsoft BASIC Professional Development System
  222. version 7.1.
  223.  
  224.  
  225. NOTE TO BBS USERS AND SHAREWARE VENDORS
  226.  
  227. If you received this file from a BBS, the following message should appear when
  228. you use PKUNZIP version 2.0 or higher to extract this program:
  229.  
  230. Authentic files Verified!   # VBI707
  231. Affordable Computer Services
  232.  
  233. If this message did not display, then the .ZIP file you received is not the
  234. original.  If you wish, call The Other BBS at the number displayed below to
  235. download the original .ZIP file (you can download on your first call), or file
  236. request EXAM through Fidonet (node number is displayed below) for the current
  237. version.
  238.  
  239.  
  240. CUSTOM PROGRAMMING
  241.  
  242. If custom programming for hire is requested, contact Affordable Computer
  243. Services by mail at the address shown below.  When writing, please enclose a
  244. telephone number where you can be reached.
  245.  
  246.  
  247. REGISTRATION
  248.  
  249. When you register ACS Page, you will receive information on how to remove the
  250. registration request and the Unregistered Copy message from the beginning of
  251. exam printouts.
  252.  
  253. If you like Exam Generator, please mail a check or money order for $20 (New
  254. Jersey residents add state sales tax) to:
  255.  
  256.     Affordable Computer Services
  257.     9 Spring Lake Gardens Ct
  258.     Spring Lake, NJ 07762-2530
  259.  
  260. Along with the registration fee, please also enclose the following:
  261.  
  262. o The name and version of the program you are registering.
  263. o Your name or company name exactly as you wish it spelled on your registered
  264.   copy (upper and lower case).
  265. o Your mailing address.
  266. o A telephone number where you can be reached so I can confirm your
  267.   registration.
  268.  
  269. Note to Amateur Radio operators:  It is recommended that you register your
  270. program with your name and call sign (example:  George Steinmetz, KB2FZH).  If
  271. you upgrade your call sign, you may reregister at no cost.
  272.  
  273. You may also register by using the American Express Card.  You may register
  274. with the card by one of the following methods:
  275.  
  276. o By mail at the above address.
  277. o By voice at 908-449-3836 or 800-929-0110*.
  278. o By   fax at 908-449-9357 or 800-929-0631*.
  279. o Online (The Other BBS) at 908-206-9770.
  280.  
  281. * Please do not use the 800 numbers except for registering, as I can not afford
  282.   to give technical support toll free.
  283.  
  284. To process your registration, you must supply the above information as well as
  285. the following information:
  286.  
  287. o Your name exactly as it appears on the card.
  288. o Your card's account number.
  289. o Your card's expiration date.
  290. o Your card's billing address.
  291.  
  292. When registering with the American Express card on The Other BBS, you should
  293. receive your registration ID in a private message within 24 hours of your
  294. registration.
  295.  
  296. Any questions about this program may be addressed to George Steinmetz on The
  297. Other BBS, 908-206-9770, Fidonet Netmail node # 1:107/468, or write, call or
  298. fax Affordable Computer Services at the address and phone numbers listed above.
  299.  
  300.  
  301. REVISION HISTORY
  302.  
  303. Version 2.0 - 09 Sep 1994
  304. o (VGA/EGA/Hercules only) When taking an exam and a question refers to a
  305.   diagram, "DIAGRAM" will display in the top right corner.  Press the space bar
  306.   or click the right mouse button to display the diagram.
  307. o Exam text can be printed, exam graphics can be printed to a dot matrix
  308.   printer specified in the /LPTn command line option.
  309. o Exam files are directly from ARRL.
  310. o Directory of exam files is automatically displayed when loading a file.  (The
  311.   prompt to enter ? for a file directory has been removed.)
  312. o Mouse can be used to select exam file when loading.
  313. o Once questions are selected from an exam file, the selected questions are
  314.   shuffled.  This way, questions in the first section of an exam file are not
  315.   always the first questions displayed when taking an exam.
  316. o All questions in a single section of an exam file can be loaded.
  317. o Status characters in exam files are now letters of the alphabet instead of
  318.   control characters.
  319. o /M command line option added to force monochrome mode on.
  320. o /NOMOUSE command line option added to disable mouse.
  321. o Right mouse button doubles as Esc key.
  322. o Center mouse button (or left & right mouse buttons) or S skips question when
  323.   taking an exam.
  324. o Registration ID removes shareware notice.
  325. o Bug fix:  If the TEMP environment variable was pointing to a nonexistent
  326.   directory, the program would crash when loading an exam file.
  327. o Swapped menu items 2 & 3 (now Load entire section and Take exam).
  328. o FCOLOR and BCOLOR environment variables used to set foreground and background
  329.   colors.
  330. o Price reduction.
  331.  
  332. Version 1.01 - 04 Feb 1992
  333. o Documentation modified - instructions on obtaining copies of the exams are
  334.   listed.  (Some questions say "See question {question number}", that means to
  335.   look at the diagram for that question on a printed copy of the exam.)
  336. o American Express Cards can be used to register program.
  337.  
  338. Version 1.0 - 10 Dec 1991
  339. o Original release.